home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / business / vend31gb.zip / VENDOR.DOC < prev    next >
Text File  |  1996-09-13  |  38KB  |  814 lines

  1.     PROGRAM TITLE:
  2.  
  3.     The Disk Vendor
  4.  
  5.  
  6.     DESCRIPTION:
  7.  
  8.     The Disk  Vendor is  a tool  for creating  "on-disk" product
  9.     catalogs.  For businesses  who would like an  alternative to
  10.     a printed catalog, The Disk Vendor will make the process  of
  11.     creating an on-disk catalog a simple one.
  12.  
  13.     The Disk Vendor run-time  module is completely menu  driven,
  14.     with a clean simple user interface, which makes it easy  for
  15.     your customers to navigate through and order from.
  16.  
  17.     The product catalogs that  you create can be  distributed on
  18.     a diskette, or printed to hardcopy format.
  19.  
  20.  
  21.     AUTHOR:
  22.  
  23.     Philip P. Kapusta
  24.     406 Monroe Avenue
  25.     Falmouth, VA 22405 USA
  26.  
  27.     74170.3550@compuserve.com
  28.     http://members.aol.com/shareware/
  29.     BBS 540 372-9680 (SYSOP) N-8-1 ANSI
  30.  
  31.  
  32.     REQUIREMENTS:
  33.  
  34.     Hard disk drive, printer, and an editor/word processor.
  35.  
  36.  
  37.     TERMS AND DEFINITIONS:
  38.  
  39.     There are several  terms that will  be used throughout  this
  40.     documentation and that  need to be  fully understood by  the
  41.     user before  you create  your own  on-disk catalog.   Please
  42.     review these definitions carefully:
  43.  
  44.     ASCII FILE: This  is a term  used to describe  any file that
  45.     you create  and save  with an  editor such  as DOS'  EDIT or
  46.     Window's  Notepad.   The Disk Vendor  does NOT come  with an
  47.     editor because most users already have a favorite editor  or
  48.     word processor that they feel  comfortable with.  We saw  no
  49.     reason to  force the  user to  use another  editor and  have
  50.     consequently not included  one.  An ASCII file contains only
  51.     characters that can be found on a standard IBM keyboard.
  52.  
  53.     CATALOG  FILE:  A  catalog  file  is  an  ASCII  file   that
  54.     contains product  numbers, product  names and  descriptions.
  55.  
  56.     These files are identified by the file extension ".CAT"  and
  57.     can  be  edited  or  created  with  a program like DOS' EDIT
  58.     editor,  or  Window's  Notepad,  or any programmer's editor.
  59.     You can even  use your favorite  word processor to  edit and
  60.     generate catalog files, but  you must remember to  save them
  61.     as  ASCII  files.    You  use   The  Disk  Vendor   compiler
  62.     (COMPILE.EXE)  to  merge  and  compress  all your individual
  63.     .CAT catalog files into one single data file (CATALOG.DAT).
  64.  
  65.     COMPILER: The compiler  is the program  that gathers all  of
  66.     your   ASCII   catalog   files   (*.CAT)   and   all   other
  67.     miscellaneous ASCII text files (*.TXT), and then merges  and
  68.     compresses  this  information  into   a  single  data   file
  69.     (CATALOG.DAT).   The Disk  Vendor compiler  also prompts the
  70.     user for information such  as quantity discount rates,  your
  71.     mailing  address,  sales  tax,  and  currency  format before
  72.     actual compilation begins.
  73.  
  74.     DATA  FILE:  The  data  file  is  a  specially formatted and
  75.     compressed  file  that  contains  ALL  your  product  names,
  76.     prices,  mailing  address,   shipping  costs,  opening   and
  77.     closing screens, etc.   This data file  is created by  using
  78.     The Disk Vendor compiler (COMPILE.EXE) and once it has  been
  79.     created it can be identified by the filename  "CATALOG.DAT".
  80.     This data file is one  of the two necessary files  that must
  81.     be placed on your distribution disk for your customers.
  82.  
  83.     HELLO AND GOODBYE FILES:  These are silly sounding  terms, I
  84.     admit, but their  names imply what  you would think.   These
  85.     are two OPTIONAL files  that are displayed at  the beginning
  86.     and end of  your on-disk catalog.   The opening screen  file
  87.     is identified with the filename "HELLO.TXT" and the  closing
  88.     screen  as  "GOODBYE.TXT".   You  can  have  a  hello   file
  89.     without  a  goodbye  file,  or  vice  versa.   One  does not
  90.     require the other.  Or you may wish to eliminate both.   The
  91.     choice is up to you.  These files are extended ASCII  files,
  92.     which means  you can  use any  of the  high ASCII characters
  93.     (graphics) such as ║ ▒ █  ╚ ½ å.  (Note: Some  printers will
  94.     not display  these characters  properly if  you are printing
  95.     the VENDOR.DOC file).
  96.  
  97.     RUN-TIME  MODULE:  Refers  to  the file "CATALOG.EXE".  This
  98.     is  the  program  that  reads  the  information in your data
  99.     file and displays it to your customers.  Remember, in  order
  100.     to create a catalog on a disk for your customers, two  files
  101.     must exist on that disk:  1) CATALOG.EXE and 2) CATALOG.DAT.
  102.  
  103.     SHIPPING  FILE:  This  is  a  small ASCII file that contains
  104.     information  on  the  various  modes  of  shipping and costs
  105.     available  to  your  customer.   It  is  identified  by  the
  106.     filename "SHIPPING.TXT".
  107.  
  108.     TEXT  FILE:   Text  files  are  ASCII  files  that   contain
  109.     miscellaneous  messages  and  notes   that  you  want   your
  110.     customers to have access to.   Text files are identified  by
  111.     the  file  extension  ".TXT"  and  must NOT be confused with
  112.     catalog  files.   Text  files  should  NOT  contain products
  113.     that you  want your  customers to  order, unless  you expect
  114.     them to  hand write  those items  at the  end of their order
  115.     form.  The contents of text files can only be viewed on  the
  116.     screen, and  no order  prompts, prices  or discount  windows
  117.     appear in conjunction with  "*.TXT" text files.   An example
  118.     of a useful  text file would  be a file  that gives a  brief
  119.     sketch about  your company  or about  how your  products are
  120.     better than your competitor's.
  121.  
  122.     WAIT FILE: This  is a special  ASCII file that  is displayed
  123.     to your  customers by  the run  time module  as it  reads in
  124.     information from the data file.   It can be considered as  a
  125.     commercial message if you wish.  It is called a "wait  file"
  126.     because its  contents are  displayed on  the screen  as your
  127.     customer waits  for the  program to  finish a  task.   It is
  128.     appropriately identified by the filename "WAIT.TXT".
  129.  
  130.     With these terms  now under your  belt you will  be ready to
  131.     begin creating your own on-disk shareware catalog.
  132.  
  133.  
  134.     LET'S GET STARTED:
  135.  
  136.     The  first  thing  that  we  recommend  a  brand new user to
  137.     do  is  to  run  the  compiler  (COMPILE.EXE) and generate a
  138.     personalized  data  file  (CATALOG.DAT).   Then  after  this
  139.     execute  the  run  time  module  (CATALOG.EXE)  so  that you
  140.     can see  how quick  and easy  it is  to generate  a catalog.
  141.     Do this right  now!  At  the DOS prompt,  just enter COMPILE
  142.     and fill in the blanks  as you are prompted by  the program.
  143.     Once you  have done  this, enter  CATALOG at  the DOS prompt
  144.     and look at your results.
  145.  
  146.     Before you  generate your  own catalog  files (*.CAT)  spend
  147.     some  time  getting  familiar  with  the  run-time    module
  148.     (CATALOG.EXE).   Explore its  features and  interface.   Try
  149.     placing a few orders as if  you were a customer.  Print  out
  150.     your order forms, print the catalog, search for words,  save
  151.     and retrieve  your orders,  etc.   By playing  with the run-
  152.     time module you will  get a feel for  the power and ease  of
  153.     use that The Disk Vendor provides you.
  154.  
  155.     Once  you  have  spent  some  time  with the run-time module
  156.     (CATALOG.EXE)  and  the  compiler  (COMPILE.EXE)  then   you
  157.     should begin creating your very own catalog files (*.CAT).
  158.  
  159.     To begin, use  your favorite text  editor or word  processor
  160.     and open a new file.  We will call the name of the new  file
  161.  
  162.     "VIRUS.CAT"  and  we  will  generate  a  catalog  file  that
  163.     contains virus  checking software  programs.   Note: You can
  164.     give the file any name you wish as long as it  contains  the
  165.     file  extension  ".CAT".   "SOFTWARE.CAT",   "DISNFECT.CAT",
  166.     "_VIRUS_.CAT" are  all valid  catalog file  names.  Whatever
  167.     is  easiest  for  you  to  remember,  give it an appropriate
  168.     filename.
  169.  
  170.     THE STRUCTURE OF A CATALOG FILE:
  171.  
  172.     Once you  begin a  new catalog  file, there  is a   specific
  173.     format that you must follow:
  174.  
  175.     1) The  very first  line of  the catalog  file (*.CAT)  must
  176.     contain  a  34  character  or  less  description.  The first
  177.     line  of  a  catalog  file  will  be  used  in the Main Menu
  178.     catalog index listing.
  179.  
  180.     2) A pound symbol "#" separates one product and  description
  181.     from  another.   The  "#"  can  be  followed by your catalog
  182.     number identifying  the product  that follows  it.   Catalog
  183.     order numbers must not be longer than 20 characters.
  184.  
  185.     3) The name of the product  follows on  the next line  after
  186.     the line that contains the "#" symbol.
  187.  
  188.     4) Any  lines after  the product  name are  used for  you to
  189.     describe that product.
  190.  
  191.     5)  Product  description  line  length  must  not  exceed 72
  192.     characters in width.  This is one rule that is often  easily
  193.     forgotten.   It  may  seem  minor,  but  for  the program to
  194.     generate  a  printed  catalog  for  your  customers  with  a
  195.     sufficient  left  margin  for  punching  holes  for a 3-ring
  196.     binder,  product  description  lines  can  not  exceed   nor
  197.     encroach upon the  margins.  Most  "good" text editors  will
  198.     have the option to define  a right margin width, and  with a
  199.     word-wrap feature,  this 72  character line  limit will  not
  200.     pose  a  problem.   Most  word  processors that export ASCII
  201.     text also will word wrap, along with being able to define  a
  202.     right margin.   The compiler will  catch any violations  and
  203.     will  stop,  bringing  to  your  attention  any  line length
  204.     violations.    I  have   a  favorite   text  editor   called
  205.     Multi-Edit,   published   by   American   Cybernetics.   For
  206.     approximately $80  it is  loaded with  everything you  could
  207.     want in a  text editor.   I highly recommend  it if you  can
  208.     afford it  and are  looking for  a text  editor besides  the
  209.     freebie Microsoft ships with DOS versions 5.0 and up.
  210.  
  211.     All right, got it?  Clear as  mud?  Probably.  So here   are
  212.     some examples  that will  help you.   Again, we  are in  our
  213.     editor and have the file "VIRUS.CAT" open.  With the  cursor
  214.  
  215.     at  the  very  top  of  the  document  (line  1),  enter   a
  216.     description used  to identify  the contents  of the  catalog
  217.     file:
  218.  
  219.     ┌─────────────────────────────────────────────────────────┐
  220.     │Virus protection software                                │
  221.     │                                                         │
  222.     │                                                         │
  223.     │                                                         │
  224.  
  225.     It is  simple so  far, isn't  it?   Just keep  the number of
  226.     characters in this description line less than 34.
  227.  
  228.     Now, on to line 2!
  229.  
  230.     As we stated above, a "#" symbol separates one product  from
  231.     another.   Since we  are about  to enter  a new product name
  232.     and description, we need to place a "#" on line 2, column 1:
  233.  
  234.     ┌─────────────────────────────────────────────────────────┐
  235.     │Virus protection software                                │
  236.     │#                                                        │
  237.     │                                                         │
  238.     │                                                         │
  239.  
  240.     If  you  wish  to  identify  your  products  using a catalog
  241.     number, now  is the  time to  do so.   Immediately following
  242.     the "#" symbol, enter your catalog number.  The number  does
  243.     not need to  be a number,  but can be  characters if you  so
  244.     choose, or a combination of both.  For example:
  245.  
  246.     ┌─────────────────────────────────────────────────────────┐
  247.     │Virus protection software                                │
  248.     │#VI040                                                   │
  249.     │                                                         │
  250.     │                                                         │
  251.  
  252.     Again, you  are not  required to  enter a  catalog number if
  253.     you choose not  to.  What  is mandatory, however,  is that a
  254.     "#" symbol exists in column 1 and must precede the line that
  255.     contains the product name.
  256.  
  257.     When you are  ready to enter  a product name,  move down one
  258.     line below the "#" and enter it:
  259.  
  260.     ┌─────────────────────────────────────────────────────────┐
  261.     │Virus protection software                                │
  262.     │#VI040                                                   │
  263.     │Expel                                                    │
  264.     │                                                         │
  265.  
  266.     In the example above  the software program "Expel"  has been
  267.     placed immediately below the line containing the "#" symbol.
  268.  
  269.     To show you some of  the features unique to The  Disk Vendor
  270.     we will let you  know here that you  can add a comment  note
  271.     on the same line  as the product name.  A "comment note" may
  272.     consist of anything you wish,  as long as it is  enclosed in
  273.     squiggly brackets  {}.   For example,  let's say  that Expel
  274.     is  obtained   wholesale  through   your  distributor   Acme
  275.     Software.  Your sales  representative with Acme Software  is
  276.     Jim Smith.  If you wanted  to make a note of that  fact, you
  277.     can add a comment note recording this.  For example:
  278.  
  279.     ┌─────────────────────────────────────────────────────────┐
  280.     │Virus protection software                                │
  281.     │#VI040                                                   │
  282.     │Expel {Acme: Jim Smith}                                  │
  283.     │                                                         │
  284.  
  285.     Above  we  see  that  the  software title Expel is purchased
  286.     through  Acme  Software,  whose  sales  rep.  is  Jim Smith.
  287.     This comment note is enclosed in {} brackets.  The  brackets
  288.     are very  important!   When this  catalog file  is compiled,
  289.     your  comment  notes  are  ignored.   Comment  notes  in  {}
  290.     brackets do not appear  to your customer because  they never
  291.     find their way  into the data  file (CATALOG.DAT).   Comment
  292.     notes are  for your  use and  are optional.   You can  enter
  293.     anything  you  wish  between  {}  brackets  -  the name of a
  294.     company, a stock bin number, an inventory count, the  weight
  295.     of  the  product,  whatever.   Again,  this  comment note is
  296.     optional.
  297.  
  298.     The next  bit of  information that  you need  to add  is the
  299.     selling  price  for  the  product.   At  the end of the line
  300.     that contains the product  name, enter its price.   Although
  301.     you can add a currency symbol before the price, this is  not
  302.     necessary, and in  fact it is  not recommended.   The reason
  303.     we do not recommend that  you enter a currency symbol  (e.g.
  304.     "$")  is  because  it  takes  up  file  space.  The run-time
  305.     module does not need  the currency symbol repeated  hundreds
  306.     of times in your *.CAT files.   One little "$" sign may  not
  307.     seem like much,  but if you  repeat this symbol  hundreds of
  308.     times  it  slowly  eats  up  disk  space.   But if you can't
  309.     break  the  habit,  that's  fine  too.   The  compiler   and
  310.     run-time module do not care.
  311.  
  312.     ┌─────────────────────────────────────────────────────────┐
  313.     │Virus protection software                                │
  314.     │#VI040                                                   │
  315.     │Expel {Acme: Jim Smith} 23.95                            │
  316.     │                                                         │
  317.  
  318.     Above we  see a  price of  $23.95 for  one unit  of "Expel".
  319.     This  $23.95  is  the  undiscounted  selling  price for this
  320.     product to  your customers.   If you  wish to  give multiple
  321.     quantity discounts, see  the compiler (COMPILE.EXE)  and set
  322.  
  323.     up  the  discount  rates  at  compile  time.   Here  in your
  324.     catalog file (*.CAT) simply  enter the price of  the product
  325.     item as shown above.
  326.  
  327.     Now that we  have entered a  product number, a  product name
  328.     and  price,  all  that  we  have  left  is  to  give Expel a
  329.     description.    The   product   description   lines   follow
  330.     immediately  below  the  line  that  contains  the product's
  331.     name and price.  For example, let's describe Expel:
  332.  
  333.     ┌─────────────────────────────────────────────────────────┐
  334.     │Virus protection software                                │
  335.     │#VI040                                                   │
  336.     │Expel {Acme: Jim Smith} 23.95                            │
  337.     │Anti-virus program that helps preserve the integrity of  │
  338.     │your files.                                              │
  339.     │                                                         │
  340.  
  341.     You can definitely get more descriptive if you wish.  We  do
  342.     not  recommend  that  you  enter  more  than  13 lines for a
  343.     program description because it will be truncated when it  is
  344.     compiled.  13 lines should  be more than enough to  describe
  345.     most programs.  Also,  keep all description lines  less than
  346.     72  characters  wide.   You  can  insert  blank lines if you
  347.     wish, and they will be preserved when compiled.
  348.  
  349.     Believe it or  not, that is  all there is  to it!   Not very
  350.     hard is it?
  351.  
  352.     To add additional programs to our "VIRUS.CAT" catalog  file,
  353.     simply repeat  steps 2-4  above.   Here is  our catalog file
  354.     after adding two more virus checking programs:
  355.  
  356.     ┌─────────────────────────────────────────────────────────┐
  357.     │Virus protection software                                │
  358.     │#VI040                                                   │
  359.     │Expel {Acme: Jim Smith} 23.95                            │
  360.     │Anti-virus program that helps preserve the integrity of  │
  361.     │your files.                                              │
  362.         │#VI107                                                   │                                             │
  363.     │Flu Shot+ 17.95                                          │
  364.     │Protects you system against virus and Trojan horse       │
  365.     │programs. Read/write protection for programs. Checks for │
  366.     │contamination and prevents virus activities.             │
  367.     │#VI100                                                   │
  368.     │Virex {Version 2.1} 34.95                                │
  369.     │Virex checks an entire disk for over 800 different virus │
  370.     │strains.  If it detects a virus, Virex will remove the   │
  371.     │virus from the program or disk.  Quarterly update        │
  372.     │virus signature lists are available from the publisher   │
  373.     │to protect your computer against new virus strains.      │
  374.  
  375.     Notice  that  you   do  NOT  repeat   the  "Virus protection
  376.  
  377.     software" category  description line.    This  occurs   only
  378.     ONCE, and must  be on the   first  line   of  your   catalog
  379.     file (VIRUS.CAT).
  380.  
  381.     We  strongly  recommend  that  you enter/insert new products
  382.     in alphabetical order.   This will make your  catalog easier
  383.     to navigate through  when viewed by  your customers.   There
  384.     exists  a  function  in  The  Disk  Vendor  run-time  module
  385.     (CATALOG.EXE)  that  lists  all  the  product  items  in the
  386.     currently selected  category.   This "quick  browse" listing
  387.     displays the products' names in the same order in which  you
  388.     entered them into the catalog file.  Therefore, if you  want
  389.     this list to appear in alphabetical order, you should  enter
  390.     the products in  alphabetical order.   The Disk Vendor  will
  391.     not sort  this list  because it  wants you  to practice good
  392.     catalog file creation and maintenance.   It is also to  your
  393.     benefit  to  enter  and  maintain  products  in alphabetical
  394.     order.  It  not only makes  it easier for  your customers to
  395.     locate products, but  it makes it  easier for YOU  to locate
  396.     products when it comes time to update or purge your  catalog
  397.     files.
  398.  
  399.     If these  3 titles  are all  you have  in the  way of  virus
  400.     checking  software programs, then  close  the    "VIRUS.CAT"
  401.     catalog file and save it to disk.
  402.  
  403.     One last  feature that  you may  be interested  in adding to
  404.     your catalog file is a  "customer note".  A "customer  note"
  405.     contains  text  information  that  helps better describe the
  406.     items that follow.  A  "customer note" does NOT have  prices
  407.     or part  numbers attached  to them.   You begin  a  customer
  408.     note with  a "#"  symbol, immediately  followed by  "NOTE#".
  409.     Move down one line and  enter a header line, then  move down
  410.     one line and enter the  ASCII text that makes up  your note.
  411.     Using the VIRUS.CAT file as an example:
  412.  
  413.     ┌─────────────────────────────────────────────────────────┐
  414.     │Virus protection software                                │
  415.     │#VI040                                                   │
  416.     │Expel {Acme: Jim Smith} 23.95                            │
  417.     │Anti-virus program that helps preserve the integrity of  │
  418.     │your files.                                              │
  419.     │#NOTE#                                                   │
  420.     │WHAT IS A COMPUTER VIRUS?                                │
  421.     │A computer virus is a program designed to replicate and  │
  422.     │spread on its own, preferable without you knowing it     │
  423.     │exists.  Like a human body, computers are vulnerable to  │
  424.  
  425.     It is best to experience a customer note in a compiled  data
  426.     file first hand in order  to appreciate its usefulness.   We
  427.     have included several customer  notes in the sample  catalog
  428.     files (*.CAT) that accompanied  this program.   Take a  good
  429.     look at these files to understand how they work.
  430.  
  431.     Customer notes  can occur  anywhere in  your catalog  files,
  432.     and they can  be unlimited in  length (1 to  1000 lines) but
  433.     are restricted to 72 columns in width.
  434.  
  435.     A few  other guidelines  that you  should be  aware of  when
  436.     working with catalog files (*.CAT):
  437.  
  438.         Use lower  case letters  as much  as possible. Upper
  439.         case  letters  do  not  compress well during compile
  440.         time.  On average you  will achieve a 40% file  size
  441.         reduction if the majority of your catalog files  are
  442.         in lower  case (before:  100,000K, after:  60,000K).
  443.         Don't  overdo  this,  of  course.   Just  type  your
  444.         catalog files as  if you were  typing a letter  to a
  445.         friend.  Keep the CAPS LOCK off, and avoid  entering
  446.         product names  in uppercase  and you will be  OK (or
  447.         is it "ok"?).
  448.  
  449.         Do not  use high  ASCII characters  in your  catalog
  450.         files (*.CAT).   Characters such as  ║  ▒  █ ╚ ½  å
  451.         will  not  be  compiled  properly.  Absolutely avoid
  452.         them!
  453.  
  454.  
  455.     OTHER NECESSARY FILES BEFORE COMPILING:
  456.  
  457.     Although your catalog files  (*.CAT) are the most  important
  458.     files  that  you  need  to  have prior to compilation, there
  459.     are additional files that you can and should create.
  460.  
  461.     The  first  mandatory  file  required  for  compilation is a
  462.     "wait file".  This file is an ASCII text file that  contains
  463.     a message for your customer while the run-time module  works
  464.     on a task.   This file can  be created with  an editor,  and
  465.     must be saved  with the filename  "WAIT.TXT".  If  this file
  466.     does not  exist when  you go  to compile  your catalog using
  467.     COMPILE.EXE the compilation process will abort.   "WAIT.TXT"
  468.     is  absolutely  mandatory.   With  The  Disk  Vendor package
  469.     that  you  have  received  a  sample  "WAIT.TXT" file can be
  470.     found  that  you  may  use  as  a guide.  The most important
  471.     things  that  you  must  remember  when  working  with   the
  472.     "WAIT.TXT" file is that it  can NOT be longer 72  characters
  473.     wide  by  17  rows  high.   Also,  this  wait  file must not
  474.     contain any high ASCII characters.
  475.  
  476.     The second (and last)  mandatory file that must  exist prior
  477.     to compilation  is a  shipping text  file.   Identified with
  478.     the filename "SHIPPING.TXT", this file contains  information
  479.     on  the  shipping/mailing  methods  that  you  provide  your
  480.     customers with,  and their  costs.   A sample "SHIPPING.TXT"
  481.     file has been included with The Disk Vendor system that  you
  482.     received and  can be  used as  a guide.   Its format  is  as
  483.     follows:
  484.  
  485.     [Type of shipping]=[Cost]
  486.  
  487.     Where  [Type of shipping]  is  replaced   with   the   words
  488.  
  489.     identifying the type  of shipping/mailing method  available,
  490.     and where  [Cost]  is replaced with  the actual cost.  These
  491.     two parameters are linked together with a "=" equals symbol.
  492.     Here is  a real  life example  of a  "SHIPPING.TXT" file, so
  493.     that you can see better the format you must follow:
  494.  
  495.     USPS (US)=2.95
  496.     USPS (Canada)=5.00
  497.     USPS (Elsewhere)=7.00
  498.     UPS Ground (US)=4.00
  499.     UPS Blue (48 Sts)=7.00
  500.     UPS Blue (AL HI PR)=8.00
  501.     UPS Red (US)=16.00
  502.     UPS Red (AL HI PR)=19.00
  503.     Federal Express overnight=20.00
  504.  
  505.     You can have  one line in  your shipping file,  or 10 lines.
  506.     You have the choice  to add or delete  any lines.  The  only
  507.     requirement  is  that  at  least  one  line  exists  in  the
  508.     "SHIPPING.TXT"  file,  and  that   you  follow  the   format
  509.     outlined above.
  510.  
  511.     Having your  catalog files  (*.CAT) and  the "WAIT.TXT"  and
  512.     "SHIPPING.TXT"  files,  you  can  now  begin the compilation
  513.     process  if  you  wish.   These  files  are mandatory before
  514.     running COMPILE.EXE.   You may wish  to add some  additional
  515.     files, but this is optional (see next section).
  516.  
  517.  
  518.     OPTIONAL TEXT FILES TO INCLUDE IN YOUR CATALOG:
  519.  
  520.     Many businesses and  companies who use  The Disk Vendor  may
  521.     wish to add additional ASCII text files for their  customers
  522.     to view.   This can  be done  with an  editor, and  the only
  523.     requirements that The Disk Vendor impose are:
  524.  
  525.     1) The text  file must NOT  contain  control  characters nor
  526.     high ASCII characters > 126 (decimal).
  527.  
  528.     2) The  text file  must be  saved with  a filename extension
  529.     ".TXT"  (short  for  "text").   "BONUS.TXT",   "README.TXT",
  530.     "COUPON.TXT", "SPECIALS.TXT" are all valid text filenames.
  531.  
  532.     3) The   text file   can be   any length  in number  of rows
  533.     (within reason), but  must not exceed  72 characters/columns
  534.     in width.
  535.  
  536.     4) The first line of your  .TXT file must be reserved for  a
  537.     description  line.   This  reserved  description  line works
  538.     exactly  as  the  description  line  in  your  catalog files
  539.     (*.CAT).   This  description  line  will  appear in the Main
  540.     Menu  catalog  index  box  and  must  contain  less  than 35
  541.     characters.   Again, this  description line  MUST reside  on
  542.     line 1 of your text file!
  543.  
  544.     What would you use .TXT files for?  Some possibilities are:
  545.  
  546.         To describe your company and its products.
  547.  
  548.         To display a discount coupon that the customer can
  549.         print using the PRINT SCREEN key and then redeem.
  550.  
  551.         To explain your return policies.
  552.  
  553.  
  554.     GRAPHIC IMAGES:
  555.  
  556.     It is said that a picture  is worth a thousand words.   This
  557.     being the  case, it  would be  nice to  add pictures of your
  558.     products  from  time  to   time.   Graphic  images  can   be
  559.     incorporated into  your catalogs  using third  party graphic
  560.     tools in the following manner.
  561.  
  562.     You will need  a third party  graphic conversion utility  to
  563.     convert your image into a stand-alone, self-executable  file
  564.     (.EXE).  The two utilities that we recommend are Grabber  by
  565.     Gerald Monroe or Graphics Workshop by Alchemy Mindworks.  It
  566.     does not matter what image  type you start with (TIFF,  PCX,
  567.     BMP,  GIF,   etc),  however   the  final   image  must    be
  568.     self-executable.
  569.  
  570.     There are three reasons why we chose to have the program use
  571.     self-executable graphics:
  572.  
  573.     1) Images converted to .EXEs load very fast
  574.  
  575.     2)  EXE  images  can  then  be  compressed  using  PKLite (a
  576.     shareware  utility  written  by  the  authors  of PKZip) and
  577.     still remain executable.
  578.  
  579.     3) Any resolution can be supported. 256 color, 16 color, and
  580.     gray scale can all be used without The Disk Vendor having to
  581.     deal with all the different image types and color depths.
  582.  
  583.     Here's an example of the benefits of using an EXE:
  584.  
  585.     If  you  have  a  PCX  image  that  is  89012 bytes in size,
  586.     converting it  to an  EXE creates  a new  file that is 90572
  587.  
  588.     bytes.  One can then compress the resulting EXE with  PKLite
  589.     which shrinks the EXE down  to 29120 bytes.  The  end result
  590.     is a  self-executable graphic  image file  that is  ready to
  591.     display, very small in size, and displays very quickly.
  592.  
  593.     PKLite will shrink  the size of  your .EXE image  by 50-80%,
  594.     resulting in an increase in available free disk space.
  595.  
  596.     So in the way of review...  Take whatever images you wish to
  597.     use and convert them to EXEs. If you have PKLite, use PKLite
  598.     to compress these EXEs to smaller EXEs.
  599.  
  600.     Once you  have a compressed, executable  graphic image,  you
  601.     will need  to rename  the file.   There are  two things  you
  602.     must take  into consideration  when you  rename your graphic
  603.     .EXE images:  1) the  file extension  (which determines  HOW
  604.     the images  are displayed),  and 2)  the 1-8  character file
  605.     name (preceding the extension).
  606.  
  607.     The filename of your graphic  .EXE image must be renamed  to
  608.     match  the  corresponding  product  item CATALOG NUMBER that
  609.     you  want  the  image  to  be  linked  to.   You must have a
  610.     catalog  item/part  number  in  order  to  use graphic image
  611.     links!   For  example,  let's  say  that  you are an antique
  612.     dealer, and that  you have an  item in your  .CAT file which
  613.     is  identified  with  the   part  number  "ROME34A"   (which
  614.     identifies a 2000  year old Roman  silver coin).   You would
  615.     then  want  to   create  a  graphic   image  that  gives   a
  616.     representation  of  this  Roman  coin,  save the image to an
  617.     .EXE file using  the file name  ROME34A.EXE, then shrink  it
  618.     with PKLite (PKLite is an optional step).
  619.  
  620.     Next, the .EXE file  extension will be changed  according to
  621.     one of the following 3 rules:
  622.  
  623.     File extension: .4CE
  624.  
  625.     If you  rename ROME34A.EXE  to ROME34A.4CE  then this  image
  626.     file  will  be  displayed  AUTOMATICALLY  when your customer
  627.     arrives  at  the  text  screen  for  your ROME34A Roman coin
  628.     description.   Actually, the  image will  be displayed prior
  629.     to the text display, and not after.  The user has no  say-so
  630.     on whether  the image  is displayed  or not  - it  is FORCED
  631.     upon  them,  and  therefore  the  file  extension  is ".4CE"
  632.     (four-ce).
  633.  
  634.     File extension: .CHO
  635.  
  636.     There is   a time   and place   for forcing   an image  upon
  637.     your customers, but you   don't want to   get too bossy  and
  638.     force  all  of  your  images  all  the time.  An alternative
  639.     would be  to give  your customers  the CHOICE  as to whether
  640.  
  641.     they wish to view the accompanying graphic image, but  still
  642.     in  a  not-so-subtle  manner.   If  this  "let your customer
  643.     choose" method  is the  way you  would like  to present   an
  644.     image  of  your antique Roman  coin, you then  should rename
  645.     your ROME34A.EXE  image file  to ROME34A.CHO.   The   ".CHO"
  646.     extension   will cause  a dialog  window    to AUTOMATICALLY
  647.     pop   up   when your  customer arrives  at the  ROME34A text
  648.     description screen.   The pop-up   dialog   will notify  the
  649.     customer that  an image  for this  product exists,  and will
  650.     ask if they  would like to  view the image  at that point  -
  651.     yes or  no.   The pop-up  dialog will  be "forced"  upon the
  652.     customer, but the customer still  has the last word and  can
  653.     decide not to view the graphic image.
  654.  
  655.     File extension: .OPT
  656.  
  657.     The last method  to display a  graphic image is  to let your
  658.     customers at their own discretion initiate the display.   By
  659.     renaming ROME34A.EXE to  ROME34A.OPT, the customer  can view
  660.     the  image  by  pressing  the  [V]  key when they are at the
  661.     product text description screen.  As a reminder, the  bottom
  662.     line  of  the  screen  will  reflect  the fact that an image
  663.     exists, should the  customer wish to  view it.   This method
  664.     of displaying  images is  called "OPTIONAL",  and hence  the
  665.     file extension of ".OPT".
  666.  
  667.  
  668.     WILDCARD IMAGES:
  669.  
  670.     If you would like to have JUST ONE executable graphic  image
  671.     linked to  several different  products in  your catalog, you
  672.     can  accomplish  this  with  "wildcard"  images.  Here is an
  673.     example of how this would work.  Let us continue to use  the
  674.     antique dealer's catalog...but let  us say that his  catalog
  675.     contained  several   Roman  coins,   with  catalog   numbers
  676.     ROME34A, ROME102C, ROME-ALL, ROME9Q, and ROME_1BC.  In  each
  677.     of  these  catalog  numbers,  the  first  four  letters  are
  678.     identical,  i.e.  "ROME".   Let  us  say  that  this antique
  679.     dealer did  not want  an image  for each  coin individually,
  680.     but rather collectively.  In other words, the dealer  wanted
  681.     just   one   graphic   image,   where   several  coins  were
  682.     collectively shown in  the image, and  that one image  to be
  683.     made available for viewing from ANY of the "ROME"  pre-fixed
  684.     catalog items.   He could  accomplish this  by creating  one
  685.     graphic  .EXE  of  all  his  coins  and name the final image
  686.     ROME#.OPT or ROME#.CHO or ROME#.4CE.  The "#" symbol in  the
  687.     file  name  represents  a  wildcard,  meaning that a graphic
  688.     link  will  be  made  if  any  catalog  number  matches  the
  689.     characters preceding the "#" wildcard.  So "ROME#.4CE"  will
  690.     display each time a  catalog number with the  letters "ROME"
  691.     appear in it.
  692.  
  693.     Note: Whenever you use any self-executing graphic images you
  694.     must remember that  these images  are not  incorporated into
  695.     the compiled  CATALOG.DAT file.  Therefore YOU MUST REMEMBER
  696.     to physically place all  graphic files on the  disk that you
  697.     will be distributing to your customers.
  698.  
  699.  
  700.     HELLO AND GOODBYE:
  701.  
  702.     Should  you  wish  to  create  a special opening screen that
  703.     your customer  views before  the Main  Menu screen  appears,
  704.     then  create  a  "hello"  file.   This  file is also created
  705.     using  an  editor,  and  must  be  saved  with  the filename
  706.     "HELLO.TXT".    Unlike   other   ASCII   text   files,   the
  707.     "HELLO.TXT" file can contain high ASCII graphic  characters.
  708.     This  will  enable  you  to  create  some attractive opening
  709.     screens with boxes  and shadows and  text.  The  "HELLO.TXT"
  710.     file  can  contain  up  to  25  lines  of  characters  by 80
  711.     characters  in  width  (the  size  of  a  normal  text  mode
  712.     screen).  Here is an example of what you could do:
  713.  
  714.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  715.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  716.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  717.       ▓▓▓▓▓┌───────────────────────────────────────┐▓▓▓▓▓▓▓▓▓
  718.       ▓▓▓▓▓│                                       │░░▓▓▓▓▓▓▓
  719.       ▓▓▓▓▓│    XYZ COMPUTERS PROUDLY PRESENTS     │░░▓▓▓▓▓▓▓
  720.       ▓▓▓▓▓│        ITS WINTER 1995 SOFTWARE       │░░▓▓▓▓▓▓▓
  721.       ▓▓▓▓▓│          CATALOG ON A DISK            │░░▓▓▓▓▓▓▓
  722.       ▓▓▓▓▓│                                       │░░▓▓▓▓▓▓▓
  723.       ▓▓▓▓▓│       Press any key to begin...       │░░▓▓▓▓▓▓▓
  724.       ▓▓▓▓▓│                                       │░░▓▓▓▓▓▓▓
  725.       ▓▓▓▓▓└───────────────────────────────────────┘░░▓▓▓▓▓▓▓
  726.       ▓▓▓▓▓▓▓░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▓▓▓▓▓▓▓
  727.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  728.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  729.  
  730.     Just remember  to include  an instruction  for your customer
  731.     to "PRESS ANY KEY TO CONTINUE..." or else you may find  your
  732.     customer  scratching  his  head  wondering  what to do next.
  733.     You may  never receive  an order  from him  because he could
  734.     not get past your opening screen!
  735.  
  736.     Likewise, if you  wish to have  a special message  appear at
  737.     the close of  the program, create  a "goodbye" file  with an
  738.     editor.   Follow exactly  the same  guidelines as  described
  739.     above  for  the  "hello"  file,   but  save  this  file   as
  740.     "GOODBYE.TXT".   Again,  remind the customer with  a message
  741.     to press any key to exit the program!
  742.  
  743.     Both the "HELLO.TXT"  and "GOODBYE.TXT" files  are optional.
  744.     You may wish not to have opening or closing screens, or  you
  745.     may wish  to have  one but  not the  other.   This is  fine.
  746.     Just delete the files you  don't need, or don't create  them
  747.     in the first place.
  748.  
  749.     For  those  who  wish  to  use a high-resolution VGA graphic
  750.     image  in  the  place  of  the  text  based  HELLO.TXT   and
  751.     GOODBYE.TXT files, generate a self-executable  640 x 480 VGA
  752.     image and use the file names  HELLO.EXE or  GOODBYE.EXE  and
  753.     place these files on the disk that you will be distributing.
  754.  
  755.  
  756.     THAT'S ALL FOLKS!:
  757.  
  758.     Speaking of "goodbyes", the  instructions above are all  you
  759.     need to get  you up and  running creating your  own personal
  760.     shareware catalog on disk.   We hope that you find  The Disk
  761.     Vendor a useful tool in marketing your products.
  762.  
  763.     Although we feel confident that  you will not find a  better
  764.     and  more flexible product  for marketing  your merchandise,
  765.     there are two groups of distributors  that would do well NOT
  766.     to  use The Disk Vendor.  To  get specific, The  Disk Vendor
  767.     must  not  be used  by  vendors  who   distribute  so-called
  768.     "Adult"  (R/X-rated) products.  We  will not  be  a party in
  769.     helping vendors  distribute such  material.  Distributors of
  770.     tobacco products are likewise prohibited from using The Disk
  771.     Vendor.  Violators  caught  using  The  Disk ⁿVendor  in the
  772.     distribution  of the above mentioned products may face legal
  773.     action.
  774.  
  775.  
  776.     SHAREWARE:
  777.  
  778.     The Disk Vendor is  shareware software and continued  use of
  779.     the program requires  you to support  the author.   Once you
  780.     have registered, you will receive the latest version of  The
  781.     Disk Vendor that will permit you to begin distributing  your
  782.     compiled  data  file  (CATALOG.DAT)  and the run-time module
  783.     (CATALOG.EXE) freely without royalties.
  784.  
  785.  
  786.     ALL IN THE FAMILY:
  787.  
  788.     Attention shareware distributors!!!!   If you would like  to
  789.     use  The  Disk  Vendor  to  distribute  public  domain   and
  790.     shareware software disks, we  have a special version  of The
  791.     Disk Vendor JUST  FOR YOU!   Custom tuned for  the shareware
  792.     industry,  The  Disk  Vendor  "shareware vendor" version has
  793.  
  794.     features  unique  to  your  industry,  such  as   multi-disk
  795.     prices,  separate  pricing  structures  for 360K, 720K, 1.2M
  796.     and 1.4M disk  sizes.  We  highly recommend this  "shareware
  797.     vendor" version  if you  need a  catalog on  disk system  to
  798.     distribute  your  shareware  library.   Contact  the program
  799.     author  with a SASE  or by phone to  learn more details.  Or
  800.     better yet, download a demo copy from our Internet Web site:
  801.  
  802.     http://members.aol.com/shareware/vendor.htm
  803.  
  804.  
  805.     We also have a utility that can convert dBase III  .DBF/.DBT
  806.     files  to  The  Disk  Vendor  ASCII  .CAT file format.  This
  807.     utility  allows  you  to  maintain  your product items in an
  808.     xBase program (such as  Alpha4/5, or Access, or  FoxPro) and
  809.     create .CAT files on  the fly.  You  can contact us for more
  810.     details on this program.
  811.  
  812.  
  813.  
  814.